home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / terms / kermit / b / ik0aaa.hlp < prev    next >
Encoding:
Text File  |  1993-05-10  |  17.6 KB  |  341 lines

  1. KERMIT-370 4.2 RELEASE NOTES, 1993 May 10
  2.  
  3. Kermit-370 4.2 has been tested under MVS/TSO, VM/CMS, MUSIC/SP, CICS,
  4. and ROSCOE at various sites.  See the end of this file for a list of
  5. Kermit files relevant to the several variants of Kermit-370.
  6.  
  7. Success has been reported with the following front ends and protocol
  8. converters.  Note that some names are given with one or more lower
  9. case x's to stand for a series of similar models with various numbers
  10. replacing the x's.
  11.  
  12.   Name, model       Type Manufacturer              Notes
  13.   ----------------- ---- ------------------------- -----
  14.   Amdahl 4705       T    Amdahl                    (2)
  15.   Cisco 516-CS,etc  S    Cisco                     (11,17)
  16.   Comten 36xx       T    NCR
  17.   Comten IPC        T,F  "                         (18,19)
  18.   Cx-80             S    Commtex                   (1,10)
  19.   Datastar 4025     G    AIS Systems
  20.   Datalynx 3174     G    Andrew Data Systems       (3)
  21.   Datalynx 3274     G    "                         (3)
  22.   Hydra II          S    JDS                       (1)
  23.   IBM 3174 AEA      A,F  IBM                       (6,18)
  24.   IBM 37x5          T    "                         (2)
  25.   IBM 3708          T,F  "                         (18,20)
  26.   IBM 4994          S    "
  27.   IBM 7171          S    "                         (12)
  28.   IBM 8232          T,S  "                         (2)
  29.   IBM 937x ASCII    S    "
  30.   IBM Series/1      S    "
  31.   Jupiter 1000      T    Intel                     (14)
  32.   K200              T,S  Fibronics                 (2,14)
  33.   K310              T,S  "                         (2,14)
  34.   K2000             T,S  "                         (2,14)
  35.   KMW S/II 3270     G    Andrew Data Systems       (16)
  36.   Leedata 8010      G    Lee Data Corp             (9,15)
  37.   Leedata 8030      G    "                         (9,15)
  38.   Leedata 874       G    "                         (9,15)
  39.   Micom 7400        F    Micom                     (7,18)
  40.   PCI 1076          G    Protocol Computers Inc
  41.   PCI 276           G    "                         (5)
  42.   Renex PCM         G    Renex Corp                (8)
  43.   Renex RPAD        G    "                         (8)
  44.   Renex RTD         G    "                         (8)
  45.   Renex TMS-x       G    "                         (8)
  46.   SIM3278/TCPIP     S    Simware                   (1,4)
  47.   SIM3278/VM        S    "                         (1,4)
  48.   SIM3278/VTAM      F    "                         (4,18)
  49.   STNxx             T,F  STRTC                     (13,18)
  50.   tn3270 (Unix)     S,F  Greg Minshall             (1,2,11,18)
  51.   Xyplex MAX 1000   F    Xyplex, Inc.              (11,18)
  52.  
  53. Here is the same list of front ends by controller type:
  54.  
  55. TTY ------ Amdahl 4705; IBM 37x5, 3708, or 8232; Comten 36xx; STNxx;
  56.            Jupiter 1000; K200, K310, or K2000.
  57. SERIES1 -- Yale ASCII system on IBM Series/1 or 4994; IBM 7171 or 937x
  58.            ASCII subsystem; Hydra II; Commtex Cx-80; SIM3278/TCPIP 2.0
  59.            or /VM 5.0; tn3270; Cisco 516-CS.
  60. GRAPHICS - Datalynx 3174 or 3274; Datastar 4025; Datastream/Leedata
  61.            8010, 8030, or 874; PCI 1076 or 276; Renex PCM, TMS-x, RPAD,
  62.            or RTD; KMW S/II 3270.
  63. AEA ------ IBM 3174 AEA (B2 or higher).
  64. FULLSCREEN IBM 3174 AEA (any); IBM 3708; Micom 7400; Sim3278/VTAM;
  65.            STNxx; tn3270; Xyplex TS.
  66.  
  67. Kermit-370 should work with any protocol converter that supports some
  68. kind of "transparent mode" or "passthrough mode".  Sometimes this goes
  69. by the name "graphics mode".  At present, three types of transparency
  70. are supported: Yale ASCII ("Series1"), SAS transparency ("Graphics"),
  71. and IBM ASCII Graphics ("AEA").  The names in parentheses are the ones
  72. used by Kermit itself and correspond to the entries under "type" in the
  73. table above.  Kermit-370 attempts to discover what kind of protocol
  74. converter it's going through, but the attempt may cause problems in
  75. certain environments (particularly in VTAM).  In that case, the
  76. diagnostic code may have to be disabled, and one particular type can be
  77. assumed.  If that doesn't work, the user can issue a SET CONTROLLER
  78. subcommand to Kermit-370 as needed.  See the BWR file for more details.
  79.  
  80. There is also a non-transparent mode supported by Kermit-370 (called
  81. FULLSCREEN), which should work with almost any kind of protocol
  82. converter, but only in combination with another Kermit that allows the
  83. Start-of-Packet character to be printable.  At present, the only such
  84. Kermits are MS-Kermit (3.12 BETA earlier than September 25) and C-Kermit
  85. (5A.180 or higher).  FULLSCREEN mode is less efficient and robust than
  86. the other modes and should not be used unless the others are not
  87. possible.
  88.  
  89. Rules of thumb for deducing the controller type by reading the manual
  90. (in order of simplicity and likelihood):
  91.  
  92. a) GRAPHICS or SERIES1 is implied if there is a transparent mode
  93.    compatible with that of one of the devices listed above.
  94.  
  95. b) SERIES1 is implied when the box runs the "Yale ASCII Communication
  96.    System" or something similar.
  97.  
  98. c) GRAPHICS is implied if the manual refers to the SAS Institute in
  99.    connection with ASCII graphics.
  100.  
  101. d) GRAPHICS is implied when transparent data may be preceded by a WCC
  102.    and 70 (hex).
  103.  
  104. e) SERIES1 is implied when transparent data must be preceded by a WCC
  105.    and either 115D7F110005 (write-read) or 115D7F110000 (write-only).
  106.  
  107. f) GRAPHICS or SERIES1 may be implied when the manufacturer is listed
  108.    in the table above with only that type of controller (unless there
  109.    are also counter-examples in the "failure" table below).
  110.  
  111. g) FULLSCREEN may be tried for any full-screen terminal controller
  112.    if all else fails.
  113.  
  114.  
  115. Certain models are known not to work with Kermit-370.  These include:
  116.  
  117.   All real 3270-type terminals (for obvious reasons).
  118.   Most PC boards that attach to co-ax cable, like the Irma board or the
  119.        IBM PC 3270 emulation board.  However, it should be possible to
  120.        write a packet driver for MS-Kermit to work in such cases.
  121.   Adacom (model unknown)                           (18)
  122.   ASM/3 w/ TS3-R 8.3.1   Cisco                     (17,18)
  123.   DECServer 200 TS       DEC
  124.   Hydra/SNA              JDS                       (18)
  125.  
  126. Notes:
  127.  
  128. 1) Some devices provide support for SERIES1 Kermit operation, but are
  129.    seen by Kermit as GRAPHICS devices.  The controller type must be set
  130.    to SERIES1 by hand for transfers to work.  Alternatively, if the only
  131.    devices in use for file transfer are SERIES1-type, Kermit can be
  132.    modified to assume SERIES1 (see the BWR file).  These devices include
  133.    the Cx-80, Hydra II, and tn3270.  The Sim3278 family also once were
  134.    like this, but that limitation has been removed for SIM3278/VM.
  135.  
  136. 2) Some front ends (such as the IBM 3725) can be used for connecting
  137.    other controllers to the mainframe.  In such cases, the lower-level
  138.    controller (typically a protocol converter) determines the setting
  139.    required by Kermit.  The IBM 8232 with TCP/IP software is a special
  140.    example of this -- it allows TTY Kermit operation for linemode Telnet
  141.    sessions from ASCII hosts and also SERIES1 or GRAPHICS (or even AEA)
  142.    operation for full-screen Telnet sessions where the appropriate
  143.    controller is attached to the originating host (or emulated, as in
  144.    the case of tn3270).  The Fibronics network boxes with KNET software
  145.    are similar.
  146.  
  147. 3) Reports are mixed or inconclusive.  Anyone with information about
  148.    these devices is urged to send it in.
  149.  
  150. 4) Simware's SIM3278 product has been rumored for several years to have
  151.    an upgrade in the works to correct the incompatible "simulation" of
  152.    Yale ASCII transparent mode.  A new product in this line, namely,
  153.    SIM3278/TCPIP 2.0, has now come out and reportedly corrects the
  154.    problem (it must be installed along with IBM's TCP/IP software).  In
  155.    addition, the latest release (5.0) of SIM3278/VM has the same fix and
  156.    is also now sensed by Kermit as a SERIES1-type device automatically.
  157.    SIM3278/TCPIP is not properly sensed; also, after an upload, it (but
  158.    not SIM3278/VM) leaves Kermit-370 waiting for a screen interrupt,
  159.    which the user must supply by hitting ENTER.  Fixes for this problem
  160.    have been promised.  SIM3278/VTAM (as of version 5.11) still does not
  161.    support the Yale ASCII transparent mode.
  162.  
  163. 5) Some PCI protocol converters require the updates that were issued in
  164.    November 1988 -- in particular, if attached through VTAM, the PCI 276
  165.    apparently does not respond correctly without an explicit command to
  166.    "unlock the keyboard" as part of the transparent I/O request.
  167.  
  168. 6) The IBM 3174 supports transparent communication only with B2 (or
  169.    higher) microcode and only for terminal types specifically defined to
  170.    have "graphics" capability.  The built-in set of terminal types
  171.    includes only two with that capability: VT241 and Tektronix 4205.
  172.    However, user-defined types can be added.  File transfers are not
  173.    allowed for lines with Host Addressible Printers.  Also, if the 3174
  174.    is owned by VTAM, and the connection is made with a logmode that
  175.    forbids the Read Partition Query (such as M2SDLCNQ), Kermit cannot
  176.    detect the AEA and will default to CONTROLLER GRAPHICS (and,
  177.    incidentally, cannot transfer files, even with CONTROLLER set to AEA
  178.    by hand).  M2SDLCQ is known to allow correct operation, but other
  179.    logmodes have not been tested.  Basically, the PSERVIC definition
  180.    must have the 80-bit set in its second byte.  The 3174 supports full
  181.    8-bit transparent communication.
  182.  
  183. 7) The Micom 7400 was formerly rumored to allow Kermit file transfer in
  184.    GRAPHICS mode, but the rumor was unfounded.  A small modification to
  185.    Kermit is necessary to support the 7400 for FULLSCREEN mode.  See
  186.    update SC92101 in the appropriate BWR file.  Typical ETOA setting
  187.    required are 74-91, 79-93, and 106-124.
  188.  
  189. 8) Renex protocol converters have a problem in BSC mode: they are not
  190.    completely transparent and may respond to ASCII data bytes as if
  191.    they were EBCDIC control characters.  Reportedly, the TMS-3 has
  192.    solved this problem.  Generally, type-ahead must be turned off to
  193.    allow Kermit to work, and graphics pass-thru must be enabled.  Also,
  194.    starting a transfer may hang your session if you have connected in
  195.    the wrong parity.  This depends on the Renex configuration.
  196.  
  197. 9) Leedata is the new name for Datastream.  Leedata boxes may need
  198.    three separate flags set in their configurations to support Kermit:
  199.    "file transfer", "transparent async", and "ASCII graphics".
  200.  
  201. 10) The Cx-80 requires that all ASCII data have the high bit set on
  202.     output.  Early releases of the emulation software for the Cx-80 were
  203.     unable to support Kermit transfers, but versions 5.04 and higher are
  204.     known to work.  Even so, the Cx-80 has a small input buffer, and the
  205.     inbound packet size should be limited to about 128.  Long outbound
  206.     packets seem to be no problem.  There is another problem with the
  207.     Cx-80 -- it echoes inbound packets.  Therefore, the start-of-packet
  208.     character should be different for send and receive.
  209.  
  210. 11) Warning: tn3270 seems unable to support uploads using packets longer
  211.     than about 256.  Also, although the original tn3270 program supports
  212.     SERIES1-style file transfer, there are a growing number of other
  213.     programs and communications packages that offer something called
  214.     a tn3270 option, and many of these do not support SERIES1 mode.  In
  215.     such circumstances, FULLSCREEN mode may be the only choice, and it
  216.     requires a modification to Kermit (see SC92101 in the appropriate
  217.     BWR file).  The supplier of any such "crippled" tn3270 application
  218.     should be informed that a complete tn3270 implementation should
  219.     include the Yale ASCII transparency feature.
  220.  
  221. 12) There is an EC, A31860, for the 7171 that is needed for transfers at
  222.     high speeds (above 9600).  It is extensive, so it may be difficult
  223.     to convince IBM that the EC is truly necessary at your site.  The
  224.     symptom of failure is loss of data from the ends of incoming
  225.     packets, apparently independent of packet size.
  226.  
  227. 13) STRTC markets a network product which offers both full-screen and
  228.     line-mode virtual terminal sessions.  Input characters are normally
  229.     echoed by the network, rather than locally, but echoing can be
  230.     suppressed if necessary.  For FULLSCREEN mode, it may be necessary
  231.     to enable flow control on both the network and the micro.
  232.  
  233. 14) This front end reportedly supports full 8-bit E-to-A conversion for
  234.     linemode sessions, provided the appropriate software is loaded:
  235.     PACKET/74 for the Intel boxes and KNET/MVS for Fibronics.
  236.  
  237. 15) The Leedata 8030 (and possibly other Leedata models) may have a bug
  238.     in the handling of SNA/SDLC pacing.  If you are unable to get file
  239.     transfers going, it may be necessary to turn off pacing both in the
  240.     NCP and the Leedata box and also to configure the VTAM logmode to
  241.     avoid pacing.  Lee Data is reportedly working on the problem.
  242.  
  243. 16) The KMW S/II 3270 requires that all ASCII data have the high bit set
  244.     on output.  It is possible to configure the KMW so that this MARK
  245.     parity passes through to the terminal or, alternatively, is changed
  246.     to SPACE parity.  256 is about the largest inbound packet size this
  247.     device will accept reliably.
  248.  
  249. 17) Cisco has added support for transparent mode, available in release
  250.     8.3(3.3) or higher.  Like other tn3270-based products, however, it
  251.     does not permit auto-detection by Kermit of the controller type, and
  252.     it imposes a restriction on packet size.  There is an effort under
  253.     way to add support for auto-detection.
  254.  
  255. 18) FULLSCREEN mode is never selected automatically.  It must be chosen
  256.     by hand and properly set up on both Kermits.  See the appropriate
  257.     installation guide (file type INS) for details.  Protocol converters
  258.     known not to support Kermit in other modes are presumed to do so in
  259.     FULLSCREEN mode, but those listed on the "failure" list above have
  260.     not been confirmed.
  261.  
  262. 19) Typical ETOA setting required are 74 91, 79 93, and 106 124.  For
  263.     FULLSCREEN mode: there may be problems in uploading without flow
  264.     control, but setting the packet size to 60 in Kermit-370 seems to
  265.     avoid them.  Use 61 as the packet character.  Also, toggle the
  266.     "Display X system" switch (by typing ctrl-A V).
  267.  
  268. 20) The "standard" character translation in the 3708 requires these ETOA
  269.     settings: 74 91, 79 33, 90 93, and 106 124.  However, there is also
  270.     an "alternative" character set that requires no such translations.
  271.     It may be necessary to set SEND PAUSE on the micro for FULLSCREEN
  272.     mode.
  273.  
  274. Models not mentioned above may or may not work with Kermit; we just have
  275. not had any feedback about them.
  276.  
  277. Kermit-370 operation also depends on the system level.  Success has been
  278. reported for CMS releases 3 through 8 (including 5.5 and 5.6) under the
  279. corresponding releases of VM/SP, VM/HPO, VM/IS, VM/XA/SP or VM/ESA; for
  280. MUSIC/SP releases 1.2 to 2.3; for TSO/E releases through 2.1 under MVS
  281. releases through 3.1; for CICS 1.6 to 2.1 under both MVS and VSE; and
  282. for ROSCOE through 5.7.  MVS/XA and MVS/ESA seem to support Kermit under
  283. TSO/E just as well as MVS/SP.  As each new system release comes out,
  284. Kermit is generally found to work under the new release, but that fact
  285. may not be reported immediately.  In the meantime, Kermit should be
  286. presumed innocent until proven guilty.  Failure has been reported for
  287. VM/370 (pre-BSEPP) and "free" TSO, but fixes may be possible.  The only
  288. other known likely failure is under CICS 3, which is not yet widely
  289. used.  The version for bimodal CMS under VM/XA and VM/ESA is available
  290. in the form of an extra update file to be applied with the normal CMS
  291. Kermit updates.
  292.  
  293. In addition, operation depends on the type of connection between the
  294. front end and the terminal.  Direct connection, of course, is the
  295. simplest and the least likely to have problems.  VTAM, although it has a
  296. few sticky points as noted above, is also capable of carrying Kermit
  297. file transfers routinely.  Troubles may arise, however, with packet-
  298. switching data networks, some of which may not support Kermit transfers
  299. at all.  Reports indicate that Telenet and Datapac/Inet are both able to
  300. carry Kermit transfers between micros and protocol-converter front ends,
  301. at least.  Tymnet, on the other hand, seems to have problems.
  302.  
  303. Since sources are provided, users are encouraged to make fixes, add
  304. support for additional protocol converters, and send their work back to
  305. us for further distribution.  Refer to IK0CON.HLP for notes on adding
  306. support for new controller types.  Refer to IK0POR.HLP for notes on
  307. porting Kermit-370 to other operating systems.
  308.  
  309. INSTALLATION
  310.  
  311. Kermit-370 version 4.2 may be installed on CMS, MVS/TSO, MUSIC/SP, CICS
  312. (either MVS or VSE), or ROSCOE ETSO systems.  Future releases may
  313. include support for other IBM 370 operating systems such as DOS-4, MTS,
  314. etc.  Release 4.2 is characterized by edit or level numbers, which
  315. should be reported when describing the exact version in use.  The
  316. current versions are 4.2.5 or 4.2.5 XA for CMS, 4.2.4 for TSO, 4.2.3 for
  317. MUSIC, 4.2.4 for CICS, and 4.2.4 ROS for ROSCOE.  These level numbers
  318. will be found, not in the base source modules, but in the update files
  319. that accompany the sources.
  320.  
  321. Kermit-370 consists of a system-independent (generic) part, common to
  322. all implementations, and a system-specific part for each system.  These
  323. files are named as follows:
  324.  
  325.   IK0*.*  The system-independent portions (all implementations).
  326.   IKC*.*  The CMS-specific portions.
  327.   IKM*.*  The MUSIC-specific portions.
  328.   IKR*.*  The ROSCOE-specific supplement to the TSO portions.
  329.   IKT*.*  The TSO-specific portions.
  330.   IKX*.*  The CICS-specific portions.
  331.  
  332. Installation instructions may be found in the following files:
  333.  
  334.   CICS:     IKXKER.INS and IKXKER.BWR
  335.   CMS:      IKCKER INS and IKCKER BWR
  336.   MUSIC/SP: IKMKER.INS and IKMKER.BWR
  337.   MVS/TSO:  IKTKER.INS and IKTKER.BWR
  338.   ROSCOE:   IKTKER.INS, IKTKER.BWR, and IKRKER.BWR
  339.  
  340. Please read the appropriate files before proceeding.
  341.